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Unless snecifl^d otherwise, t*e 
terms "RoX" and "RS*-11" |n*ply 
wRSX-110" , 
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i,0 INTRODUCTION 



l t l This functional' specification will cover botn 
Interior oeslgn cons! aerations and outward appearance of 
I/O handler Task to support ,nu 1 1 1 n | e t.ejatyoe aevlses un< 
RSX-110', The Index |s be|ow, 

A, HANDLER SYSTEM INTERFACE J.PARA 

8, INTERRUPT SERVICE ROUTINE: CONVENTIONS CPAPA 



m UUT:-'TV HAN3u£ r < TAS.< 



2,2 HANDLE* INTERFACE 



■» r> c v n ▼ r '•' 



2,1 HA^O'-'A-'E INTE^CE 
A. 



8, 



Tei'a + yoe devices stancjarriiv suprc-rxeo 
?eis>y33 Hi^aTer Task Intsrfcrt ^"vl 

1', KSR33. i 12 char/sec 
2', XSR35 - 50 char/sec 



***~ 



oy 

;e re; 



3, LA32 CO£Ci,'RITEf;] - 33 char/sec 

papal UI3 

4, v/TSS - Var Table rate 

Ajl tr.g ?>DOve tftlstyse advices 
operator ccrsQi&J will *e jnjtu. 
If interface* to the POP-ll vh t:-<. 

I.t ?5 currently ahvT si one* :-a' : : 
te ! etyne-c I iss devices may af>-- : .' 
a,»e Tied 3 so tnat this srvjulc 
or oo lews wjtn the Handier, T""C 
hewevep -vjii not susoort a io* ^>'- 
R e a d s r / P y n c .". , 



0, A^ :?es8"X) a raxlnu^ of l 7 devj.-. -;?■ 
tc cse «n40ieri for *nv °S*«U- ^r,: 
to restrictions on the aijocatac: v-;c 



srcv.ii 



;ys;^ f 



* Full aup;e* 6-bit asy^e h ror,'!^ 
Syp'ort >■ i > • extanc to --£ 
KL-llS, i-T'Oivins a max fffiu^ . rate 
one Tai'styoe Qevlce, 



w • * - /» . 
♦' 3'": 



multj-tty handler task 



pace: 



2,2 USER TASK INTERFACE 

A", The Teletype Handler' ! ] Ke an 
Handler, receives |ts Queued 
active tas* «|a either of tv.e t* 
Directives, Tne user tas* pro 
with a request. node to the lo 
CLU'NIj desired, as we t I as 
narameters neccessary for Its 
system determines which pnys| 
LUN has been assigned to and 
linkage and user Identifier Info 
■node to the aparoprfate nana I or' 



ra-z 



si ca 
wit 
ex 
ca I 
afte 
rma t 
s re 



otner 
nests 

E"UE I 
s th.fi 
I un 
h th 
ecut J 
dev | c 
r ari 
! on, 
n u p s.t 



PSX 
f r on 
/n Sy 
d| r ec 
i t nu 
e var 
on, 
e the 

Queues 



ti 

— . >- 



Sr 
t 



sf, 



85 The *ab|e below gives descriptions 
I/O functions performed for the 
Teletype Handier, These c^dRS will 
■ w|tn similar commands on a wjd 
devices, thus promoting device Ind 
user may also specify an I/O status 
event flag to tne Handler for an 
through the reauast node, The ha 
the user evant flaq to oe set t I f s 
"the I/O function (s complete, and 
word C T f so3c|fed] to be set to 
"^determln Inq tne outcome of i*a I/C 
type of failure Incurred}, 



of 
u*>e 

D 

e v 

ec c 
wo 
y 

nd I 
s?c 

tn 
an 
Csj 



che 
r tas 
e co 
a r I 3 1 
naonc 
ra, a 
I/O 

er wf 
I f led 
c usp 

OC tg 
ccess 



var 1 d 

k ov + 
moat j - 
y of f 

2". T 
n d / n r 
f l; n c 1 1 
I ! ra- 
J 1 w- 
r stat 
I va i 
, or t 



CODE a C0mha.no 



DESCRIPTION OF HANDLER 
FUNCTION 



042? 



^RITE 



0632 WRITEITEXT FILE 



1000 



i?!i)2 



READ 



READjNO ECHO 



Wr I tes a I I ne from a I T 
buffer wl th|n ' t 
request|na t a s '< , 



Writes a 
spec I f I ed 
node, t ■) 
te I etyne . 



text ff 

in tno reou" 

user s c I e c *. 

Thls Is f 



current Teletype .'anji 
method of lesooo I I n 
CSoe soctlon 2,3',] 

Reads a line into a 1 1 
buf f er w I tn j n t 
resulting task, 

Same as PE^O, eyeept 

Inout characters " 

echoed on the toletv, 
device, 
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3.420 ATTACH 



23S53 DETACH 



Oedjeates tne -eclat', 
dev ! ce sdqc ? f ! er! to t 
user tasK I sr?ujnn + 
"ATTACH," Onlv t»- 
yser's request nodes «.! 
be processed dv ? 
handler for tnat rev]-: 
reoafdiess of + 
Dr lor I ty of other y« 
nodes, 

Oetacnes the user 
from the t e I s t v a <» ? e v i ,» 
Negates an ATTACH, . 




E', 



3', +3 



4*. 
5-, 



+ 4 

+ 5 



s Successful comc)ot 

s Successful co-no lot! oh of Roadi 

operator ter-1 1 1 natsd fine wi 

ALTMODE, not CA 3 HIAGE FET'^'i. 
s R6ad complete'! CRcnuso c^era' 

typed i^ax|Tu- -iu~Dor of ormactei 

No terminator s<-en, 
: tij t y p s d by o a p r a t c r , I' 

termfnatort Clf write cceratfon] 
s tS typed iy one rater r r f «■*' 

operat | or ] 



Cff 



6', 
7', 



1?! 

Hi 

12, 



-6 

-13 

-14 



-21? 
-22? 

r999 



= I i local f unct Ion code 

= I I I' eg a I ftu ff ^r an a r ess 

= I I I e o a | o u f f a r count 

s Tel'otyoe Device Inca^ab 

d o s I r * d I/O function 
s Illegal' cn»r^cters 
= T i meout occur r eri C I f 

operat I on! 
= No node available for reouq 



The general format of tnc request ^o^o 
user passes to the QUEUE J/0 Directive i 
In the I/O Coerations Specification, Tr.o 
b|t definitions of worcs 5-12 of tne none 



I* 

n 

st -U' 

h*t ' 

fi o i i * 

a? t a i 

no^ 1 "" 
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PACE 



are rjef|ne'J so'fey by the I/O Fynctton, For 
functions available from the Teletype Han*|r 
three basic detailed formats of woras 5-1? exj< 
Format A Is for I/O- functions "WRlTC'i "^a^", ? 
'•READJMO ECHO."*, Format « \s for functions M .M:-' 
and "DETACH'-, Format C Is for "WRITE jTEXT FILE.' 

1 # , FORMAT A 

W0# MEANING 

05 The .16 b|t address of t*e start 
the text ||ne buffer relative to • 
user tas* 

06 Specfal flodo wore C I f sot:3 
a, SITS ?!-ia = U«USEn 

B, BtTS 14a pass a|l charact* 
CRUBOUT, »U etc', J 

C, BIT 15 = l 'no|s ^yts count wan- 
CtepnMnator will rot en-J line 

2\ FORMAT 9 

NO SPECIALIZED I/O FUNCTION WORDS . 
NECESSARY 

3*, FORMAT C J 

THE FORMAT WILL SE IDENTICAL TO T"E *'C' 
FILE" REQUEST AS DEFINED 3Y THE FILES PROJE' 
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2,3 SPOOLER INTEPFACC 



A, Teletype spooilnq for RSX-llP w|i| 



9, 



Pi 



0, 






be perforce* 
a separate handUr task, for all user I/ ,; en _, 
functions assigned via U'JW's, to a S p ^>; 
dev|re* f This "Spooler H?.n".|er" wU< ( Ootisl 
throughout ysjng Its own disk ?an I oq I at | on , 

Therefore It wT I I enable the user t*sk to funn 
Its Teletype outout d!r«ct!v to alsk and px: 
This wIM botn free core, *ni Oranaticp I ly ""='" 
runtime for Teletype I/O bound user tasKsi^wo vr- 
des|rab|e features', 

A|so, Tike the Teletype Handler, the -functio- 
Jnterface of the Te|et y ne S oo|er w|tn the u-= 
tasK will be similar to otner ; <oV-Ji^ I/O 
pro^otlnn user t?sk device | nafip«^ence . 
sjmp'jy change tne us°r cutout 
device to "spooler 



I'jh fro 1 



hares l er 

To scon 

t e I e t v 



dev 



ce 



The Teletype Handler Itself 
facf I It I as for . a non-riev|ce 
spooling, Hero* the u 
I'jngs di raet |y to , 
utilizing the I/O 
provided ov the 
completion Cajtner a 
user program exit or 
reouest noop. will ce queued 



will also r r o v I 

Independent, for* 

er task "spools" Its outn 

a text f I! a on t*e *i I s 

record hand | Inn co^bf Mt 1 

F|ies rroj£c + '. d o o n t ? 

t e r "' I n a 1 1 n g -cnaractar, or 

ahortl, a "'..'RITFl Trxr r:i. 



hanaler, l h e entire unorCen •- 
be oijtnut on the user speclfiei T 
user soec I f l«d pr lor I ty. 



for the 

text HI* 

e ! e *"• y o e ♦ 



f> I c t v 
l i t* 



un-'er 



By the judicious use of 
break un |ono cutouts. 



m U 1 1 1 p i e text f I i es 
a user tas,< s n o u M he 



to "spool" at 



| of effective --eTS uf <*• 
soonlstica:|on3 provided oy tn* Telotvoe ^ 
Handler Task, It is t»|s tor* of ^ 
capability th a t w||| be orovldeo »n|tia|iy, 



sroo I I 
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3,0 INTERRUPT SERVICE ROUTINE ! CONVENT IO.NS 



3,1 Special Characters 

A', 



C, 



Ei 



The typing of tc shall cause the Teletype Intern, 
Service Routine to tr|acjer the MCR senuenr 
Nothing w,| I I be echoed', It w I I' I be left to the >■ 
tasK to have set |tse|f to key off chls vanaoi 
and perform legality checking. E Is this r 
console Teletype? '>;hai |s Its status?] There ^ 
be no effect on any tty Input or output operation 

The typing cf tx Shalt cause tne Teletype Intern 
Service Routine to pass the time, ait? nnd 
device numoer, LvU the Send System ni recti v*3 •■ 
start up Cvla tne Request ' Svsten directive] a u< 
task specified at System Generation C^t'i] tjr 
This task could be useo to, for e*a-p|e, *|iow ■ 
MCR to run on tne teletype fox which the tX ■. 
typed. The task rav or .-nay not bo Ijrese- 
deoerdlna on the Installation^ need for pucn 
feature, In any case »x can oe typ^d fro-. 
Teletype device, and there will he no effect on 
TTY Input or outout operation, 

During write operations, the typing of t5 sir 
cause a +5 to be returned In tne status word. . 
the tyolng of tj shall causa a + « to oe retumea 
well as truncating she outout In tne .nlddle *>t t 
||ne* The user tasK can use tn|s Information 
Cfor examole] stoo a long printout on that un 
jn r*ad ; mods, tj will clear the current I 
buffeTi and echo as CRLf, 

current i 

»H it D tC 

current Innut character, This allows a ennfu 
tyDlst to examine exactly what n e has tvono I 
tha system, 

The tyolng of »I shall cause a horizontal f a ^ to 
echo'd, ragardlflss of whether the Teletype Dov 
has a Horizontal Tab hardware capability, 

The following characters ?|*ays have r.pec 
meanings, 

1, ALTMODE C233, 375, 3763 - ends line innuf, 
echo on outout, Converter) to 223', WT | I a| 
' furthar console Input on the sane output im 



0, The tyo|ng of t» shall cause the 

buffer Cif In read mo^eD to oo retype 
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2, CARRIAGE RETURN C2153 t ends I f no Input, 

3', TAB CHORIZONTAL, VERTICAL, FORM FEED! * If n 
provided by Teletype <iav|ce, thay w I II 
simulated, 

4', R.UB0UT C377J- - Deletes last character an1 ac* 
as "N"i Tf any previous c^aractnrs In «t 
buffer', 
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A, The Teletype Interrupt Service Routine Is that p^r 
of the handier task rooked directly Into +n 
Interrupt chain, It is assembled with the Teletyc 
Handjen but Is run In Kernel ^ode, 

8',- The interrupt Service Routine will oa structured t 

be "LINEWARE"', In ot*er *'oras, |t will make »v 

Teletype appear as a |Tne device to the Teletyc 
Hand|ep, 

C', For each Teletype Device specified In the RU^ Ctn 
••' maximum of "N», where "N" <1S Is tho number c 
teletype devices the Handler was assented < 
eontrol^, 4 control words and 4?' line buf'i 
locations will be available In the Teletvj 
Handlen set in the format* 

WD 2)0 = SJATUS OF teletype:', IP SET J 

BIT 00 = CHAR OPERATION IN PROGRESS 

BIT 01 = LINE OPERATIC/- 1 IN PROCESS 

BIT ?2 = jCb IN PROGRESS CATTACliEDl 

PIT 33 = Nh ECHO REQ^'I^EO 

BIT ^4 = SFT IN POSITION FOR CVrPPRINT 

RIT 05 = CONTROL CHARACTER dEIMG PRESSED 

BIT P6 = LINE IS 0Vfc.P 

BIT ?>7 = UNUSED 



BIT 26 = "WRITE" IN PROGRESS 

BIT P9 = "WRITE FILE" If* P D Q0f<E3S 

BIT 10 = "READ" IN PROGRESS 

BIT 11 = UNUSED 

BIT 12 = UNUSED 



BIT 13 = UNUSED 

BIT 14 = PASS ALL CHARACTERS L M G~E3 

BIT 15 = WHOLE tJYTE COUNT WANTED C*OnEl 

CNOTES BITS 0-12 ARE SET I,\TE*ML TO THE HANDLE 
BITS *13-15 ARE PROVIDED 3Y THE USER I/O F'JNCTI 
MODE WORT,] 

WO 01 » STATUS OF TTY HARDWARE CSET VIA SCENT.* 
SETJ 

BIT «B = DEVICE HAT »Q KEY n OARO CREA^ ^ISA c l- r 
BIT SI = DFVICE HAS NQ PRINTER CVRIfE ni*A«u r 
BIT *2 = NOT FULL DUPLEX [CHARACTER c r 
OISABLED] 
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BJT 33 a HORIZONTAL T AR ENABLED VIA UWM°Z 
BJT 554 s VERTICAL TA* ENABLED VIA WAPO'U.'E 
BIT 35 a FORM P£F.D E'-'AHLED VIA HARDWARE 
BIT H6 s PARITY REQUIRED FOB DEVICE 
BIT ^7 s UNUSED 



BITS 2S-15 = MAX NUMBER OF NULLS \EL"i 
FOLLOWING CARRIAGE RETURN "0" ?■■: 
TELETYPE OEVICEi Tq AVOID OVE^PPI^T', 



WQS ?2-S'5 = BUFFER POINTERS 



HO 252 8 CURRENT COUHT CM'tfRER DF CHARACTERS TH 
BEFORE MAXIMUM; BYTE COU"T EXC r E0E^3 

WO 23 a ADDRESS OF CURRENT CHARACTER PYTE 3E! 
PROCESSED 

WO 04 s °OJNTe;R- TO USER "ODE 

WD D5> PUD ENTRY POINTS* FOR THIS DEVICE 



WDS-P6«B8 = CHARACTER PROCESSING wOK^S 

WD S36 

BYTE 3 = CHARACTER CODE BEING PRCESSFO 
BYTE 1 = RELATIVE PROCESSOR L^CATIGV 

Wp iJ7 s POINTER T CURRENT CHARACTER BE1"G ECHO 



n i -» 



ID iJR 



BYTE n = NUMBER OF CHARACTERS SINCE LAST 
BYTE 1 = MUMJEh 0" CR 3 1 *\ C ^ lAST D Ar,t_ 



WOS 9-4S = TEXT PUFFER ^QR CURRENT LT'E', fT 1 ' 
ALLOWS DOUBLE BUTFC^F'G G't ALL TEL£TY D E Li 
I/O FDR UP TO 60 CHARACTERS,] 



« Sons samoio values are! \<s t *3'}*'*, 1**2*7*7* 



